home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / msdos / colrdir2.zip / DI.DOC < prev    next >
Text File  |  1993-05-21  |  7KB  |  169 lines
  1. ┌───────────────────────────────────────────────────────────────────────┐
  2. │   ┌╥──┐      ┬╖            ┬╥──┐  ┬╥  ┬╥──┐                           │
  3. │   │║    ┌╥─┐ │║ ┌╥─┐ ┬╥─┐  │║  │  │║  │╟─┬┘           Version 1.2     │
  4. │   └╨──┘ └╨─┘ ┴╨ └╨─┘ ┴╨    ┴╨──┘  ┴╨  ┴╨ └  tm                        │
  5. └───────────────────────────────────────────────────────────────────────┘
  6.  
  7. ColorDIR is a replacement for DOS's DIR command. It uses color to make it
  8. easy to spot different types of files. It sorts by name, extension, date
  9. or size, and it even handles international date and time formats for my
  10. Canadian friends. 
  11.  
  12.  
  13. ┌──────────────┐
  14. │ REQUIREMENTS │
  15. └──────────────┘
  16.  
  17. A color monitor is preferred, but a monochrome monitor will work.
  18.  
  19. MS-DOS version 2.0 or later (PC-DOS version 3.0 or later).
  20.  
  21.  
  22. ┌───────────┐
  23. │ OPERATION │
  24. └───────────┘
  25.  
  26. Typing: "DI /?" shows this help summary.
  27.  
  28. Usage:   DI [drive:] [\path\] [filename] [.ext] [/options]
  29.  
  30.      Options:      /N  Sort by Name                /W  Use Wide format
  31.                    /E  Sort by Extension           /I  Include dir sizes
  32.                    /S  Sort by Size                /A  Use normal ASCII
  33.                    /D  Sort by Date
  34.  
  35. ColorDIR works like DOS's DIR command. You can specify a drive or path if
  36. you want to look at something other than the current directory. You can
  37. also specify a wildcard search such as D*.EXE, which lists all EXE files
  38. that start with D. Up to 1500 files can be displayed.
  39.  
  40. If you want detailed information about the files then use one of the sort
  41. options. These show the file sizes in bytes, their attributes, date and
  42. time. Attributes are: "s" for system, "a" for archive, "r" for read-only,
  43. and "h" for hidden.
  44.  
  45. The /W option is normally not used since ColorDIR defaults to the wide,
  46. 6-column format when more than six files are listed. But if you do a
  47. sort, you can force the wide format with a /W.
  48.  
  49. The /I option Includes the sizes of subdirectories. Using this option on
  50. the root directory is slow since all the directories are scanned.
  51. Attributes are not shown to make room for the large sizes. This option
  52. can be used with any of the other options.
  53.  
  54. The /A option replaces the extended characters used to draw the border
  55. lines with normal ASCII characters. This is useful if the directory is
  56. redirected to a printer that does not have extended characters. For
  57. example: DI > PRN /A
  58.  
  59. ColorDIR pauses automatically when the screen is full so DOS's pause
  60. option (/P) is unnecessary. Press most any key to continue, or press
  61. "Esc" to skip to the bottom line. 
  62.  
  63. The bottom line is similar to DOS's DIR command: "files" includes
  64. subdirectories, "bytes" is the sum of the sizes of the listed files,
  65. and "free" is the number of unused bytes on the disk. The usage
  66. efficiency and current date and time are also shown.
  67.  
  68. The usage efficiency is the percentage of disk space actually used by the
  69. listed files due to the effect of clusters. For example, a file only one
  70. byte long must use a complete cluster, which is 1024 bytes on some
  71. drives. In this case the efficiency is less than 0.1% 
  72.  
  73. Formats for the time and date are gotten from the country information.
  74. DOS's default format is USA, but it can be changed to Canadian-French,
  75. for example, by adding the following command to your CONFIG.SYS file:
  76.  
  77.             COUNTRY=002,,C:\DOS\COUNTRY.SYS
  78.  
  79.  
  80.  
  81. ┌────────────┐
  82. │ DISCLAIMER │
  83. └────────────┘
  84.  
  85. LOREN BLANEY DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND
  86. DOCUMENTATION, WHETHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
  87. ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  88. PURPOSE. IN NO EVENT WILL LOREN BLANEY, OR ANYONE ELSE INVOLVED IN THE
  89. CREATION AND PRODUCTION OF THIS SOFTWARE, BE LIABLE FOR DAMAGES, INCLUD-
  90. ING ANY LOSS OF PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENT-
  91. IAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE OR DOCUMENTATION,
  92. EVEN IF LOREN BLANEY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  93. THE PERSON USING THIS SOFTWARE BEARS ALL RISK AS TO ITS QUALITY AND
  94. PERFORMANCE.
  95.  
  96. Some states do not allow the exclusion of the limit of liability for
  97. consequential or incidental damages, so the above limitation may not
  98. apply to you.
  99.  
  100. If any provision of this Disclaimer shall be unlawful, void, or for any
  101. reason unenforceable, then that provision shall be deemed severable from
  102. this Disclaimer and shall not affect the validity and enforceability of
  103. the remaining provisions of this Disclaimer. This Disclaimer shall be
  104. governed by the laws of the State of Colorado and shall inure to the
  105. benefit of Loren Blaney and any successors, administrators, heirs and
  106. assigns.
  107.  
  108.  
  109. ┌─────────┐
  110. │ LICENSE │
  111. └─────────┘
  112.  
  113. ColorDIR is copyrighted shareware. You may try it out for 30 days, after
  114. which you must either register it or stop using it. You are encouraged to
  115. make copies and distribute them to others, but all files must be included
  116. and unmodified. You may charge a fee for your copies, but that fee does
  117. not reduce the registration fee owed to the author by the user. If you,
  118. or your company, uses more than one copy of ColorDIR simultaneously, each
  119. copy must be registered. 
  120.  
  121. The registration fee is $10.00 (US). This allows you to legally use
  122. ColorDIR after the 30-day trial period. Registered users will be notified
  123. of any significant upgrades. By registering you also give me an incentive
  124. to maintain and improve ColorDIR, and to create new programs.
  125.  
  126. Checks must be drawable on a United States bank. (My bank charges a
  127. $10.00 processing fee for foreign checks.) If your bank charges too much
  128. for money orders, you can always send US currency.
  129.  
  130. Quantity discounts for site licenses:
  131.  
  132.             Copies   Price each
  133.             ──────   ──────────
  134.                1        $10
  135.                2          9
  136.                5          8
  137.               10          7
  138.               20          6
  139.               50          5
  140.              100          4
  141.              200          3
  142.              500          2
  143.  
  144.  
  145.  
  146. ┌────────────┐
  147. │ CUSTOMIZER │
  148. └────────────┘
  149.  
  150. If you would like another program that lets you to change the colors and
  151. extensions in ColorDIR then send an additional $5.00 to cover shipping
  152. and handling for a disk (specify 5¼ or 3½). I'll also give you the latest
  153. version of ColorDIR.
  154.  
  155. The customizer lets you set up your own file extensions and change the
  156. colors of everything. You can also select upper or lower case names,
  157. increasing or decreasing order for dates and sizes, and you can show or
  158. hide system and hidden files. For my meticulous critics, there's even an
  159. option to connect the border lines with T joints.
  160.  
  161.  
  162.  
  163. If you think of something ColorDIR needs (or find a bug it doesn't need),
  164. please let me know. Some changes are very easy to make.
  165.  
  166.             Loren Blaney
  167.             Magnolia Star Route
  168.             Nederland, CO 80466  (USA)
  169.